home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 21 / AACD 21.iso / AACD / Utilities / Help / locale / help / english / sys / list.doc < prev    next >
Encoding:
Text File  |  2000-10-06  |  4.5 KB  |  206 lines
  1. LIST
  2.  
  3. Lists specified information about directories and files.
  4.  
  5. Format
  6.  
  7. LIST [{<dir | pattern | filename>}] [P | PAT <pattern>] [KEYS] [DATES]
  8. [NODATES] [TO <name>] [DUB <string>] [SINCE <date>] [UPTO <date>] [QUICK]
  9. [BLOCK] [NOHEAD] [FILES] [DIRS] [LFORMAT <string>] [ALL]
  10.  
  11. Template
  12.  
  13. DIR/M,P=PAT/K,KEYS/S,DATES/S,NODATES/S,TO/K,SUB/K,SINCE/K,UPTO/K,QUICK/S,BLOC
  14. K/S,NOHEAD/S,FILES/S,DIRS/S,LFORMAT/K,ALL/S
  15.  
  16. Location
  17.  
  18. C:
  19.  
  20. LIST displays information about the contents of the current directory. If you
  21. specify a <dir>, <pattern>, or <filename> argument, LIST displays information
  22. about the specified directory, all directories or files that match the
  23. pattern, or the specified file, respectively. The PAT argument lets you
  24. specify an additional pattern to match.
  25.  
  26. Unless other options are specified, LIST displays the following:
  27.  
  28. name
  29.  
  30. The name of the file or directory.
  31.  
  32. size
  33.  
  34. The size of the file in bytes. If there is nothing in this file, the field
  35. reads "empty". For directories, this entry reads "Dir".
  36.  
  37. protection
  38.  
  39. The protection bits that are set for this file are shown as letters. The
  40. clear (unset) bits are shown as hyphens. Most files show the default
  41. protection bits, ----rwed for readable/writable/executable/deletable. See the
  42. PROTECT command for more on protection bits.
  43.  
  44. date and time
  45.  
  46. The date and time the file was created or last changed.
  47.  
  48. comment
  49.  
  50. The comment, if any, placed on the file using the FILENOTE command. It is
  51. preceded by a colon (:).
  52.  
  53. LIST uses the following options to change the way the output is displayed:
  54.  
  55. KEYS
  56.  
  57. Displays the block number of each file header or directory.
  58.  
  59. DATES
  60.  
  61. Displays dates. (For example, DD-MMM-YY is the USA default).
  62.  
  63. NODATES
  64.  
  65. Does not display date and time information.
  66.  
  67. TO <name>
  68.  
  69. Specifies an output file or device for LIST; by default, LIST outputs to the
  70. current window.
  71.  
  72. SUB <string>
  73.  
  74. Lists only files containing the substring <string>.
  75.  
  76. SINCE <date>
  77.  
  78. Lists only files timestamped on or after the specified date.
  79.  
  80. UPTO <date>
  81.  
  82. Lists only files timestamped on or before the specified date.
  83.  
  84. QUICK
  85.  
  86. Lists only the names of files and directories.
  87.  
  88. BLOCK
  89.  
  90. Displays file sizes in 512-byte blocks, rather than bytes.
  91.  
  92. NOHEAD
  93.  
  94. Suppresses printing of the header and summary information.
  95.  
  96. FILES
  97.  
  98. Lists files only (no directories).
  99.  
  100. DIRS
  101.  
  102. Lists directories only (no files).
  103.  
  104. LFORMAT
  105.  
  106. Defines a string to specially format LIST output.
  107.  
  108. ALL
  109.  
  110. Lists the contents of all directories and subdirectories.
  111.  
  112. The LFORMAT option modifies the output of LIST and can be used as a quick
  113. method of generating script files. When using LFORMAT, specify an output
  114. format string; this string is output for each file or directory normally
  115. listed. It can contain any text you specify, plus the usual LIST output
  116. information. When LFORMAT is specified, the QUICK and NOHEAD options are
  117. automatically selected. To save the output, you must redirect it to a file by
  118. using the > operator or specifying a TO file. (For examples using the LIST
  119. LFORMAT option, see Chapter 8.)
  120.  
  121. The available substitution operators are:
  122.  
  123. %A
  124.  
  125. Prints file attributes (protection bits).
  126.  
  127. %B
  128.  
  129. Prints size of file in blocks.
  130.  
  131. %C
  132.  
  133. Prints any comments attached to the file.
  134.  
  135. %D
  136.  
  137. Prints the date associated with the file.
  138.  
  139. %E
  140.  
  141. Prints just the file extension.
  142.  
  143. %K
  144.  
  145. Prints the file key block number.
  146.  
  147. %L
  148.  
  149. Prints the length of the file in bytes.
  150.  
  151. %M
  152.  
  153. Prints the file name only, omitting any extension.
  154.  
  155. %N
  156.  
  157. Prints the name of the file.
  158.  
  159. %P
  160.  
  161. Prints the file parent path.
  162.  
  163. %S
  164.  
  165. Superseded by %N and %P; still functional.
  166.  
  167. %T
  168.  
  169. Prints the time associated with the file.
  170.  
  171. You can put a length specifier and/or a justification specifier between the
  172. percent sign (%) and the field specifier. To specify left justification,
  173. place a minus sign (-) before the length specifier. Otherwise, the
  174. information displayed is right justified.
  175.  
  176. The default output of the LIST command uses the following specification:
  177.  
  178. %-24 %7L %A %D %T
  179.  
  180. Example 1:
  181.  
  182. > LIST Dirs
  183.  
  184. Prefs Dir ----rwed 27-Jun-93 11:43:59
  185. T Dir ----rwed 16-Jul-93 11:37:43
  186. Trashcan Dir ----rwed 21-Jun-93 17:54:20
  187.  
  188. Only the directories in the current directory, in this case SYS:, are listed.
  189. (A shortened version of the typical output is shown above.)
  190.  
  191. Example 2:
  192.  
  193. 1> LIST LI#? TO RAM:Libs.file
  194.  
  195. LIST searches for any directories or files that start with LI. The output of
  196. LIST is sent to Libs.file in RAM:.
  197.  
  198. Example 3:
  199.  
  200. 1> LIST DF0:Documents UPTO 09-Oct-90
  201.  
  202. Only the files or directories in the Documents directory of DF0: that have
  203. not been changed since October 9, 1990 are listed.
  204.  
  205. For further examples using the LIST command, see Chapter 8.
  206.